home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / access / first.zip / FIRSTLIB.TXT < prev   
Text File  |  1993-01-26  |  10KB  |  257 lines
  1. ========================================================================
  2. FIRSTLIB.MDA
  3. ========================================================================
  4.  
  5. ABOUT FIRSTLIB
  6. --------------
  7.  
  8. FIRSTLIB is a Microsoft Access library database designed to make 
  9. designing databases a little easier.  The tools provided in the 
  10. database are design-oriented in that they help you to create new forms,
  11. menus, modules, and procedures.
  12.  
  13.  
  14. Like other library databases, FIRSTLIB can be invoked from any
  15. database you're currently working on.  An Autokeys macro is included
  16. that you can import into your databases.  Once this macro has been
  17. imported, if you have FIRSTLIB.MDA correctly installed, you are a
  18. keystroke away from the tools provided.
  19.  
  20.  
  21. DISCLAIMER
  22. ----------
  23.  
  24. FIRSTLIB.MDA is provided "as-is" without warranty of any kind,
  25. either expressed or implied, including byt not limited to the 
  26. warranties of merchantibility and/or fitness for a particular
  27. purpose.  The user assumes the entire risk as to the accuracy
  28. and the use of this Microsoft Access Library Database.
  29.  
  30. FIRSTLIB.MDA may be freely copied and distributed subject to the
  31. following conditions: 1) This document must accompany FIRSTLIB.MDA;
  32. 2) FIRSTLIB.MDA should not be modified in any way; 3) FIRSTLIB.MDA
  33. may not be distributed for profit.
  34.  
  35.  
  36.  
  37. INSTALLATION
  38. ------------
  39.  
  40. To install FIRSTLIB.MDA, open MSACCESS.INI in the Windows directory, and
  41. add the following option:
  42.  
  43. [Libraries]
  44.  
  45.   C:\MYDIR\FIRSTLIB.MDA=ro
  46.  
  47. Also, FIRSTLIB.MDA requires the following special entry in the same .INI 
  48. file:
  49.  
  50. [MenuBuilder]
  51.  
  52.   Path=C:\MYDIR\FIRSTLIB.MDA
  53.  
  54. You must exit and restart Access for the change to take effect.
  55.  
  56.  
  57. WHAT'S INCLUDED
  58. ---------------
  59.  
  60. There are four main tools that FIRSTLIB provides: A Form Design
  61. tools library, a Macro to Module converter, an expanded
  62. New Procedure dialog for writing Access Basic Code, and an
  63. automatic custom menu builder.  Each of these four tools
  64. can be accessed by running a function in the Immediate
  65. Window, or by pressing a key if you have imported the Autokeys 
  66. macro.  The table below shows how to invoke each of the tools.
  67.  
  68.  
  69. TOOL                            FUNCTION NAME         KEYSTROKE
  70. ---------                       ------------------    -----------------------
  71. Form Design Tool Palette        flib_OpenFDTools      Shift-F12
  72. Macro to Module Coverter        flib_ConvertMacros    Ctrl-F12
  73. Extended New Procedure Dialog   flib_NewProc          F12
  74. Menu Builder                    BuilderFormOnMenu     Shift-F2 in OnMenu Prop
  75.  
  76. So, if you want to convert macros to modules, you can go to the
  77. Immediate Window and type:
  78.  
  79.   ? flib_ConvertMacros()
  80.  
  81. or simply hit Ctrl-F12 if you have the Autokeys macro loaded.  (Note
  82. that the Extended New Procedure Dialog is only applicable in a module,
  83. so you must have a module active for this function to work.)
  84.  
  85.  
  86.  
  87. THE TOOL PALETTE
  88. ----------------
  89.  
  90. FD Tools is a collection of form design tools that can be used with
  91. any form.  At present, these tools cannot be used with reports, but
  92. this should change soon.  
  93.  
  94. The tool palette contains 2 rows of 6 tools.  Each has a nifty little
  95. icon, but I can't show those here (since this is a text file).  Instead, 
  96. I will reference each tool by its row and column, in the format R1C1, 
  97. R1C2, etc.
  98.  
  99. R1C1: Sunken Frame
  100. ------------------
  101. This tool will put a sunken rectangle behind *any* control, including
  102. subforms, listboxes, dropdowns, etc.  If you change the size of the
  103. control, and then click the Sunken Frame button again, FIRSTLIB
  104. will find any existing frame and simply resize it.  FIRSTLIB finds
  105. existing rectangles by first looking at the control name for all
  106. rectangles on the form.  If the control name is of the pattern
  107. "FieldNameFrame" and you are trying to frame "FieldName," then
  108. "FieldNameFrame" will be resized.  If no rectangle is found with the
  109. correct name, FIRSTLIB will look for a rectangle that is overlapping
  110. the control in question.  If this search returns no rectangles, then
  111. a new frame is created.
  112.  
  113. R1C2: Shadow Frame
  114. ------------------
  115. This tool follows the same rules as the Sunken Frame tool above, but
  116. it creates a frame that looks like a shadow, very similar to the Wizard
  117. Shadow style.  You can easily switch an exisitng Sunken Frame to a
  118. Shadow Frame and vice versa.
  119.  
  120. R1C3: Size Object
  121. -----------------
  122. This tool brings up the dimensions for an object in TWIPS.  On this
  123. dialog you can change, Top, Bottom, Left, Right, Height, and Width.
  124. In the future, I plan to make the measurement settable, so you could
  125. specify dimensions in twips, inches, and/or centimeters.
  126.  
  127. R1C4: Make Controls Same Size
  128. -----------------------------
  129. Clicking this button will bring up a list of all the controls on the
  130. active form.  You can then select the controls that you wish to apply
  131. this operation to.  Next, simply specify the new height and width for
  132. all of the selected controls and click OK.  The controls will be
  133. resized to the same height and width.  If you leave the height or
  134. width field blank, it will be ignored when sizing the controls.
  135. NOTE: The Unit of Measurement option group has no effect.  All measurements
  136. are still in TWIPS.
  137.  
  138. R1C5: Vertical Alignment Tool
  139. -----------------------------
  140. This tool works much like R1C4 in that a list of controls is brought
  141. up and you are allowed to select the controls you wish to apply the
  142. operation to.  The vertical alignment tool will take each control
  143. you selected, in the order that you selected them, and space them
  144. evenly on the form according to the spacing you have specified.
  145.  
  146. NOTE: There is currently a bug here in that the controls you have
  147. selected are not sorted by the time that they were selected.  I
  148. will fix this soon.
  149.  
  150. R1C6: Horizontal Alignment Tool
  151. -------------------------------
  152. Same as the Vertical Alignment Tool only horizontal.  Great for
  153. simulating datasheets in form view.
  154.  
  155. R2C1-R2C4: Alignment Tools
  156. --------------------------
  157. These four tools are essentially short cuts for the menu options
  158. Align Left, Align Right, Align Top and Align Bottom.
  159.  
  160. R2C5-R2C6: Bring To Front / Send To Back
  161. ----------------------------------------
  162. Another group of short cut buttons for another group of commonly
  163. used menu options.
  164.  
  165.  
  166.  
  167. MACRO TO MODULE CONVERTER
  168. -------------------------
  169.  
  170. When you invoke the Macro to Module Converter, a dialog will appear
  171. that lists all the Macros in the current database.  After selecting
  172. a Macro to convert, you must provide a valid file name.  FIRSTLIB
  173. will write the Basic equivalent to the macro directly to this file.
  174. Once complete, simply load the file into a module as text, and you're
  175. ready to go (almost, see below).
  176.  
  177. All of the conditions that you specified in the Macro will be
  178. converted to "If" statements, and support for "..." is included.
  179. Certain Actions will be converted to the ABC equivalent (like
  180. MsgBox), and others will not be included at all (like AddMenu),
  181. but the majority of actions will be converted to the "DoCmd Action"
  182. format.
  183.  
  184. The dialog provides two options that control the format of the code
  185. that is generated.  The first option, Include Error Handling Code,
  186. will automagically add the appropriate 'On Error' type stuff if
  187. it is checked.  If an error occurs, a MsgBox will give a description
  188. of the problem.
  189.  
  190. The second option, Include Function Names in Error Dialogs, is only
  191. applicable if the first option is checked.  If selected, this second
  192. option will place the title of the function in the title of the MsgBox 
  193. that is shown when an error occurs.
  194.  
  195.  
  196.  
  197. EXTENDED NEW PROCEDURE DIALOG
  198. -----------------------------
  199.  
  200. When writing basic code, you can quickly add a new procedure by choosing
  201. [Edit] [New Procedure] from the menu.  Unfortunately, this option 
  202. provides relatively simple procedure creation functionality.  
  203.  
  204. The Extended New Procedure dialog allows you to specify not only the
  205. name and type of the procedure to add, but also the return value
  206. (if the procedure is a function) and comments (if you wish).
  207.  
  208. Furthermore, FIRSTLIB can also automatically generate error handling
  209. code as described in the previous section.
  210.  
  211. Once you've described the function that you wish to create, click the
  212. OK button and the function will be created in the currently active
  213. module.  Note that FIRSTLIB uses SendKeys to create the function, so
  214. if you provide a duplicate function name, disaster could be the result.
  215. For the most part however, functions should be added quickly and
  216. cleanly.
  217.  
  218.  
  219. MENU BUILDER
  220. ------------
  221.  
  222. The custom Menu Builder can be invoked from any form in design view
  223. by simply moving to the property window, placing the cursor in the 
  224. OnMenu property, and pressing Shift-F2.  A dialog will appear that
  225. looks much like Visual Basic's menu dialog.  This dialog allows you
  226. to define both top level and sub menu items.
  227.  
  228. The upper half of the dialog contains the criteria for the currently
  229. selected menu item.  The lower half is a list of all the menu items
  230. in the current menu bar.  A menu item can either be a top level item,
  231. meaning that it is shown in the main Access menu bar, or a sub menu
  232. item, which means that it can be selected from one of the pop-up menus.
  233.  
  234. By default all items are top-level.  To make an item a pop-up menu item,
  235. select the item in the list and click the -> arrow button.  An elipsis
  236. (...) should appear to the left of the item in the listbox, and the
  237. Action and Argument fields should become enabled in the top half of
  238. the dialog.
  239.  
  240. When you are finished building your menu, simply click Save.  (If you
  241. have not yet saved the menu, you will be prompted for a filename.)  The
  242. Macros that make up the menu bar will be automatically created for you.
  243. Later, if you want to edit the menu bar again, make sure you do so
  244. by pressing Shift-F2 in the same OnMenu property.  This will ensure
  245. that the macros are always saved in a format that is readable by the
  246. builder.  Never edit the Macros directly.
  247.  
  248.  
  249.  
  250.  
  251. QUESTIONS/COMMENTS
  252. ------------------
  253.  
  254. If you have questions or comments about FIRSTLIB, please contact
  255. me directly through EMail: andrewm@microsoft.com.
  256.  
  257.